|
2.14
|
AT^SCFG Extended Configuration Settings
|
AT^SCFG can be used to query and configure various settings of the TC65.
The
AT^SCFG read command returns a list of all supported parameters and their current values.
The
AT^SCFG write command queries a configuration parameter (if no value is entered) or sets its value(s).
Input of parameter names is always coded in GSM character set, parameter values are expected to be given as specified via
AT+CSCS.
The following error messages may be returned by the
AT^SCFG write commands:
|
|
|
|
|
|
|
|
|
|
|
|
|
^SCFG: "GPRS/PersistentContexts", (list of supported <gpc>s)
|
|
|
|
|
|
|
^SCFG: "MEShutdown/OnIgnition", (list of supported <msi>s)
|
|
|
|
|
|
|
|
|
^SCFG: "Radio/OutputPowerReduction", (list of supported <ropr>s)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
^SCFG: "URC/Ringline/ActiveTime", (list of supported <urat>s)
|
^SCFG: "Userware/Autostart", (list of supported <ua>s)
|
^SCFG: "Userware/Autostart/AppName", (max. string lengths of <uaa>)
|
^SCFG: "Userware/Autostart/Delay", (list of supported <uad>s)
|
|
|
|
|
|
|
|
|
^SCFG: "Userware/Watchdog", (list of supported <wd>)
|
|
|
This parameter specifies the AT command(s) to be launched automatically. Each AT command is executed in the same way as if it were entered online, this means that command concatenation is possible if supported by the given commands. If serial multiplex mode is activated (
AT+CMUX) the first logical channel is used, i.e. CSD calls (data or fax) could be set up. If the TC65 is busy on the serial channel command execution will be delayed until ongoing action is finished.
The first two characters of the automatically launched AT command shall be "at".
Please refer to examples below.
Value will be saved while switching off the TC65 via AT commands (e.g.
AT+CFUN or
AT^SMSO) and restored on next power up.
This parameter specifies emergency call numbers on SIM cards without ECC field. The parameter has no influence on the commonly used emergency numbers 112 and 911 which are always supported.
Please refer also to Section
7.3, ATD where you can find a list of emergency call numbers supported if no SIM is inserted.
The value range of
<ecc> is "0"..."255". To select or deselect an emergency number calculate the sum of the values of all desired numbers and use the resulting value. For example, for "08" (2) and "118" (8) please enter the value (10).
Parameter is global for the ME, non-volatile and will not be reset by
AT&F.
When the ATS0=
<n> (
<n>>0) command is received, the MT will attempt to perform a GPRS attach.
When the ATS0=
<n> (
<n>>0) command is received, the MT will not attempt to perform a GPRS attach.
If the ME is in power saving mode 7 or 9 (see AT+CFUN) and hardware flow control is in use (
AT\Q3) and the RTS line is inactive and there are incoming IP packets for a GPRS context which is online, then the RING line will be activated once, for a time which is configured by the parameter "URC/Ringline/ActiveTime" (
<urat>). The RING line to be used can be configured with the parameter "URC/Ringline" (
<uri>).
The two parameters <map> and
<mapos> can be used to enable/disable the Airplane mode. Airplane mode shuts down the radio part of the ME (PA and receiver), causes the ME to log off from the GSM/GPRS network and disables all AT commands whose execution requires a radio connection. A list of AT commands supported during Airplane mode can be found in Section
23.4, Availability of AT Commands Depending on Operating Mode of ME. The benefit of Airplane mode is that, at locations where no RF emission is allowed (typically airplanes, hospitals etc.), the subscriber can continue using network-independent features rather than powering off the entire device (e.g. a PDA or smartphone).
If the subscriber tries to use an AT command not available in Airplane mode the response "+CME ERROR: Unsupported AT command" is returned.
Parameter
<map> allows entering or leaving the Airplane mode any time during operation, eliminating the need to enter the SIM PIN again. It can be used no matter whether the parameter
<mapos> is "on" or "off".
Parameter
<map> is global for all interfaces, volatile and will not be reset by
AT&F.
Causes the ME to enter the Airplane mode each time the ME is restarted or reset.
After restart or reset, the URC "
^SYSSTART AIRPLANE MODE" appears and parameter
<map> is "on". The SIM PIN can be entered using the
AT+CPIN command. This enables the ME to read data from the SIM and give access to SIM PIN dependent AT commands which are available in Airplane mode, such as phonebook commands or several SMS commands. To notify the user when SIM data are accessible it is recommended to activate the "
^SSIM READY" URC and store its presentation mode to the user profile with
AT&W.
To return from Airplane mode to Normal mode set the parameter
<map> to "off" as described above. If PIN authentication was already done, the ME will try now to register to the GSM network.
The parameter specifies two different switching modes of the ignition line IGT: The line may either be used only to switch on the ME, or to switch it on and off.
Please note that the factory default is different depending on the product type.
Designed as a ready-to-use solution the TC65 Terminal is delivered with
<msi>="on". Changing the delivery default of the TC65 Terminal disables the switch-off function of its ON/OFF push button and its ONOFF line on the GPIO connector, and therefore, is not allowed.
TC65 Modules are factory set to
<msi>="off". It is only in the case of modules that the application manufacturer may decide to change the default setting. We recommend that great care be taken before changing the switch mode of IGT. It is of vital importance that the following conditions are met to ensure that IGT works properly as ON/OFF switch:
Switch-on condition: If the ME is off the IGT line must be asserted for at least 400 ms and then released.
Switch-off condition: If the ME is on the IGT line must be asserted for at least 1 s and then released. The switch-off routine is identical with the shutdown procedure initiated by the
AT^SMSO command, i.e. the ME performs an orderly shutdown and issues the "
^SHUTDOWN" URC.
Before switching off the ME wait at least 2 seconds after startup.
Furthermore, particular attention shall be given to the USB interface and the DTR signal: The USB interface and the DTR line shall either be decoupled from IGT to avoid unintentional shutdown of the ME, or require special precautions if you wish to restart the ME by plugging the USB cable or to toggle IGT from DTR. For further details please refer to
[2] and
[3].
Parameter
<msi> is global for all interfaces, non-volatile and will not be reset by
AT&F.
The feature "Radio/Band" with its parameters <rba>,
<rbp> and
<rbc> can be used to set and query preferences for selecting frequency bands.
The TC65 normally uses an automode algorithm designed to recognize automatically the radio bands of the current country, typically a combination of two bands. Commonly used dual-band combinations are, for example, 900/1800 MHz in European countries or 850/1900 MHz in North America. The standard radio band combination of a country depends on the ARFCNs (Absolute Frequency Channel Number) and the MCCs (Mobile Country Code) visible at the air interface. This enables the ME to easily find the standard band or band combination of a country every time after power-up and, thus, usually eliminates the need for the subscriber to make any changes. So, if automode is used and the allowed bands are not restricted with
<rba> the response parameter
<rbc> shows the standard band(s) of the current area.
As an alternative, if any bands other than those automatically selected by the ME are needed, the automode can be influenced using the
AT^SCFG command. This may be necessary, for example, when running tests of GSM applications, when access to specific radio bands shall be restricted or when the final product is not intended for operation in certain countries.
Before changing the parameters
<rba> or
<rbp> ensure that no network activity occurs. The write command cannot be executed when making a call, or sending / receiving short messages.
Execution of the write command causes the ME to deregister from and re-register to the network, no matter whether the selected
<rbp> or
<rba> setting really changes. Therefore, it is useful to have the URC "
+CREG" enabled. Please note that
<firstscan>=1 ("Radio/FirstScan" feature enabled) may override the settings selected
<rba>. The status of the SIM PIN authentication remains unchanged, eliminating the need to enter the SIM PIN again after the change.
The parameter
<rba> is intended to restrict the allowed bands to less than four bands. By default, all four bands are allowed. Each band not contained in
<rba> is generally disabled.
All bands of
<rbp> must be contained in the range set with
<rba>. The response parameter
<rbc> will never show a value outside the
<rba> range.
<rba> has precedence over
<rbp> and
<rbc>.
The
<rba> value to select resp. deselect radio bands can be either a single band value or a multiple band value as listed below. The multiple band values are calculated by adding up the appropriate single band values.
Parameter
<rba> is global for the ME, non-volatile and will not be reset by
AT&F.
The write command will trigger the band selection, starting with the user preference specified by <rbp>. This means bands contained in
<rbp> will be searched first, regardless of the standard band combination of the current country. The final result of the band selection can be read from
<rbc>.
If
<rbp> was a band or band combination which differs from the standard band(s) and the requested band(s) are not visible at the air interface the ME reverts to the standard band(s) of this country. Please note that the band selection procedure is independent of the registration procedure, i.e. the ME selects a band no matter whether or not there is a PLMN (Public Land Mobile Network) the ME can register to. So, if the
<rbp> was a band or band combination supported by the country, but currently no PLMN can be found, the ME will select the "preferred" band (indicated by
<rbc>) without registering to the network. To avoid registration problems, for example when the settings are configured for testing the GSM application it is recommended that the tester first activates the desired band(s) on the test equipment and then executes the
AT^SCFG write command. Besides remember that the network registration also depends on the settings made with
AT+COPS.
The
<rbp> is volatile and cannot be read back with the
AT^SCFG read command. This is because the value is used only for triggering one single search operation.
The parameter
<rbp> may be one of the single bands or one of the four dualband combinations listed below. All preferred bands must be contained in the range of allowed bands set with
<rba>, invalid combinations are not accepted. To give priority to a certain single band or band combination and suppress all others simply select the same value both for
<rbp> and
<rba>.
<rbc> is the single band or dual band combination currently used by the ME, found either by the automode algorithm or after the network search was triggered with
<rbp>. The
<rbc> value is saved on power down. When restarted next time the ME tries to select the same band(s) if these are visible. If the band(s) stored with
<rbc> are not visible the ME uses the standard band(s) of the current country and consequently updates the
<rbc> value.
<rbc> is only a response parameter returned either after sending the read command
AT^SCFG? or writing
AT^SCFG="Radio/Band".
In addition to
<rbc> and to allow the subscriber to be notified whenever the selected band changes it is recommended to activate the "
+CIEV: band" (see Section
3.3, AT^SIND).
NormalWhen trying to register to a network the ME sleeps longer than in "Fast mode" before restarting a network scan.
Fast"Fast mode" reduces the time the ME sleeps before restarting a network scan when trying to register.
Advantage: If the ME is out of network service it may take less time to find a network.
Disadvantage: Higher current consumption while the ME is out of network service.
Note: To monitor the search process it may be useful to have the "+CREG" URC enabled. Each time the network search starts, the URC "
+CREG" equals "2" (searching). When the network search stops, the URC is issued again, indicating either "0" (not registered), or "1" (registered) or "5" (registered, roaming). As long as no network can be found, the URC will be toggling between "2" and "0".
Disabled Band search follows the rules specified for the "Radio/Band" parameter
<rba>. So the ME will try to register to a network within a band or band combination currently visible at the air interface. If no network can be found the ME will continue to search, but only within the same band combination.
Enabled Band search will start within the current band combination. If this band combination provides only Limited Service or no service at all, the ME starts to scan all other bands, i.e. it will try to find a band outside the currently visible standard band combination. This mechanism will override the band settings selected with
<rba>.
Bands outside the current band combination will be scanned only one time. If there is still no appropriate network, the ME will resume the network search in the first band combination.
Conditions for using this mode:
AT+COPS must be set to "Automatic mode" (
AT+COPS=0).
Whilst the "Radio/FirstScan" feature is active other band or network selection commands cannot be used, such as
AT+COPS,
AT^SNWS or the "Radio/Band" parameters
<rba> and
<rbp> of
AT^SCFG.
Size of TCP receive buffer in bytes.Possible number of parallel socket connections depending on buffer size:
- 5200 bytes (default): max. 8 connections
- 10000 bytes (medium): max. 4 connections
- 20000 bytes (high): max. 2 connections
This parameter determines the time (in seconds) the TCP/IP stack will wait before starting the first retransmission of packets during the initial connection establishment phase.
The TCP protocol ensures the retransmission of packets several times at increasing intervals until some upper limit is reached.
This mechanism prevents packet loss and serious congestion problems.
Parameter is global for the ME and non-volatile. Use of default value is recommended. If changed the new value takes effect the next time you start an Internet service with
AT^SISO.
This parameter determines the maximum number of times to retransmit TCP packets while the service is in connected state. If the service is still connecting (connection setup) another algorithm applies.
The value set with
<tcpMr> will be assumed as default for the
<srvParmTag> "tcpMR" when a new service profile is created with
AT^SISS. In each service profile, you can set another "tcpMR" value which has precedence over the global value set with
AT^SCFG. Existing service profiles are not affected when you change the global value via
AT^SCFG.
Parameter is global for the ME and non-volatile. Use of default value is recommended.
This parameter specifies the number of seconds to wait before closing a connection if TCP/IP packets are not acknowledged.
Setting the maximum value is practically equivalent to deactivating the tcpOT mechanism because the maximum time would never be reached by the TCP/IP stack.
The value set with
<tcpOt> will be assumed as default for the
<srvParmTag> "tcpOT" when a new service profile is created with
AT^SISS. However, in each service profile, you can set another "tcpOT" value which has precedence over the global value set with
AT^SCFG. Existing service profiles are not affected when you change the global value via
AT^SCFG.
Parameter is non-volatile. Use of default value is recommended.
Disable URCs related to Internet service commands. This requires the host application to employ polling techniques when using the Internet service AT commands: The host application is responsible to retrieve all status information needed to control an Internet session. The method is referred to as polling mode.
Siemens standard USB Device Descriptor. If
<deviceDescr>=0 is set all other parameters related to "Serial/USB/DDD" cannot be changed. For use in a Windows environment, the "usbmodem.inf" file delivered with TC65 shall be present.
Note that whenever the TC65 firmware is updated over the USB interface the Siemens standard configuration must be present. Therefore, before starting a TC65 firmware download be sure that
<deviceDescr>=0 is activated and, under Windows, the Siemens "usbmodem.inf" file can be found. Remember to restart the ME after reverting to
<deviceDescr>=0 and before starting the firmware download.
Customer specific USB Device Descriptor.If
<deviceDescr>=1 is set all other parameters related to "Serial/USB/DDD" can be changed.
Customizing the USB Device Descriptor configuration requires a unique Vendor ID obtained from the USB Implementers Forum. For information please refer to http://www.usb.org.
For use under Windows a customized INF file for the USB modem must be present. An easy way to create this file is copying the Siemens "usbmodem.inf" file and overwriting the equivalent values changed with
AT^SCFG, usually at least the Vendor ID, Product ID and, optionally, the manufacturer string. This is because the strings given for the customized "Serial/USB/DDD" parameters must be identical with those contained in the INF file.
Please refer to USB.ORG [30] to find the language IDs currently defined for USB devices. If parameter
<langId> is not specified, the default value of the Siemens standard USB Device Descriptor configuration applies (US English).
Parameter is global, stored non-volatile in ME and not reset by
AT&F. Setting will be active after TC65 restart.
Parameter length: maximum 4 characters.
Optional serial number. Empty string if not used, like in the case of the Siemens standard USB Device Descriptor configuration.
A serial number has several advantages. For example, it enables the host to assign the same virtual COM port to same USB device even though the device is connected to another USB port. This eliminates the need for the host to load the driver again.
Parameter is global, stored non-volatile in ME and not reset by
AT&F. Setting will be active after TC65 restart. If parameter
<serialNo> is not specified, the default value of Siemens standard USB Device Descriptor applies.
Parameter length: maximum 63 characters.
URC "+CIEV: call" will be issued only when a Call Status transition ends in state "active" or "unknown" (see Section
7.1, Call Status Information) for a call in the list of active calls.
URC "+CIEV: call" will be issued when any state transition (including transitions beginning or ending in state "unknown") occurs in the list of active calls, or when a traffic channel is established.
URC "^SLCC" will be issued when any state transition (including transitions beginning or ending in state "unknown") occurs in the list of active calls, or when a traffic channel is established.
Specifies if the userware is started automatically on power-up.If autostart is enabled, it is no longer possible to use the multiplexer (see
AT+CMUX).
If the Java application starts, all current calls will be terminated.
The Userware/Autostart mechanism takes effect also in Airplane modeand CHARGE-ONLY-MODE.
Parameter is global, stored non-volatile in ME and not reset by
AT&F.
Password used to change values of userware parameters.Parameter is global, stored non-volatile in ME and not reset by
AT&F.
The maximum length of a given password is 8 characters. It is allowed to have an empty password (this is the value on delivery of the module).
CAUTION: Be careful not to lose the password. There is no way to reset or recover a forgotten password or to obtain a new password from the manufacturer.
If <umode>= "normal": Parameter is ignored.
If
<umode>= "debug": Port number used by debugger.
If
<umode>= "test": Port number of the test server.
Discard data. The value is global, stored non-volatile in ME and is not reset by
AT&F.
System.out is routed to a UDP socket. The parameter requires that the port number be given with
<intvalue>.
"UDP" is intended only for use with the Java IDE and will be set automatically each time you start the debugging emulator of the TC65 (on-device debugging). Closing the debugger causes the ME to reboot and automatically resets the
<if> value last selected. This eliminates any need for manually setting "UDP" with
AT^SCFG, and, besides, allows you to select another System.out target to be used when not debugging. Due to this, the value "UDP" is volatile unlike all other
<if> values, and switching to "UDP" is not supported while Java is running.
If <if>= "UDP": UDP port number. It is recommended to use a number greater than 1023.
If
<if>= "FILE": Size of the log file in bytes, values less then 1024 are not supported.
This parameter is required only if parameter <if> for the Java System.out is set to "FILE". It specifies the absolute path and the file name of the log. The local Flash File system is identified by: "A:", directory separator is "/" (002Fh).
The underline character "_" (005Fh) is not supported.
The log is split into two concatenated files, each using half of the entire log size set with parameter
<intvalue>. Each file name consists of the name specified with parameter
<filename> and the numeric extension "0" or "1" automatically appended, for example "a:/java/log.txt.0" for the first part of the log and "a:/java/log.txt.1" for the second part. When the first log file reaches half of the log size, the System.out is written to the second file. When the second file is used up, the ME starts to overwrite the first one.
Parameter is global, stored non-volatile in ME and not reset by
AT&F.
Parameter length: maximum 125 characters.
|
•
|
Be careful using <AutoExecType>=1 with small period values and shutdown or reset AT commands, since only little time remains to change these settings again after TC65 restart.
|
|
•
|
If <AutoExecATC> uses AT commands containing secret data, this information may be retrieved with AT^SCFG?. For instance, this applies if using AT+CPIN.
|
|
EXAMPLE 1
|
Usage of "AutoExec": Enable sending of a short message (SMS) on next DTR activation (OFF-ON transition). Sent SMS is assumed to be stored at first location of storage selected with AT+CPMS and AT^SSMSS, i.e. SMS may be sent either from SIM or ME storage. Also refer to AT+CMSS and AT+CMGW. Since SMS transmission and ongoing calls are possible at the same time there is no need to wait until all calls have ended ( <AutoExecMode>=0).
|
|
EXAMPLE 2
|
Usage of "AutoExec": Configure TC65 to perform a reset every 10 hours. The execution of the reset command shall be deferred until after any calls have ended. For details regarding software controlled power down refer to AT+CFUN and AT^SMSO.
|
|
EXAMPLE 3
|
Usage of "AutoExec": Switch off the ME after three minutes without restarting it. For details regarding software controlled power down refer to AT+CFUN and AT^SMSO. Please keep in mind that if the GSM alphabet is enabled special characters within the executed AT command shall be issued as escape sequences. A list of typical escape sequences can be found in Section 1.5.1, GSM alphabet tables and UCS2 character values. For example, the caret character "^" included in all Siemens defined AT commands shall be given as "\1B\14".
|
|
EXAMPLE 4
|
Usage of "AutoExec": Deactivate a timer-driven Autoexec function configured at <AutoExecIndex> 2 (such as the periodic automatic reset or the automatic switch-off functions configured in the preceding examples):
|
|
EXAMPLE 5
|
Usage of "URC/Ringline" and "URC/Datamode/Ringline":
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
URCs on this interface will be indicated by an activated RING0 no matter whether or not the TA-TE link is reserved.
|
|
|
|
|
|
|
URCs on this interface will be indicated by an activated RING0 if the TA-TE link is not reserved and by BREAK if the TA-TE link is reserved.
|
|
|
|
|
|
|
|
|
|